home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3c / strxfrm.z / strxfrm
Encoding:
Text File  |  1998-10-20  |  3.9 KB  |  67 lines
  1.  
  2.  
  3.  
  4. ssssttttrrrrxxxxffffrrrrmmmm((((3333CCCC))))                                                        ssssttttrrrrxxxxffffrrrrmmmm((((3333CCCC))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _ssss_tttt_rrrr_xxxx_ffff_rrrr_mmmm - string transformation
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_ssss_tttt_rrrr_iiii_nnnn_gggg_...._hhhh_>>>>
  13.  
  14.      _ssss_iiii_zzzz_eeee______tttt _ssss_tttt_rrrr_xxxx_ffff_rrrr_mmmm _((((_cccc_hhhh_aaaa_rrrr _****_ssss_1111_,,,, _cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_ssss_2222_,,,, _ssss_iiii_zzzz_eeee______tttt _nnnn_))))_;;;;
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      _ssss_tttt_rrrr_xxxx_ffff_rrrr_mmmm transforms the string _s_2 and places the resulting string into the
  18.      array _s_1.  The transformation is such that if _ssss_tttt_rrrr_cccc_mmmm_pppp is applied to two
  19.      transformed strings, it returns a value greater than, equal to, or less
  20.      than zero, corresponding to the result of the _ssss_tttt_rrrr_cccc_oooo_llll_llll function applied to
  21.      the same two original strings.  The transformation is based on the
  22.      program's locale for category _LLLL_CCCC______CCCC_OOOO_LLLL_LLLL_AAAA_TTTT_EEEE [see _ssss_eeee_tttt_llll_oooo_cccc_aaaa_llll_eeee(3C)].
  23.  
  24.      No more than _n characters will be placed into the resulting array pointed
  25.      to by _s_1, including the terminating null character. If _n is 0, then _s_1 is
  26.      permitted to be a null pointer. If copying takes place between objects
  27.      that overlap, the behavior is undefined.
  28.  
  29.      _ssss_tttt_rrrr_xxxx_ffff_rrrr_mmmm returns the length of the transformed string (not including the
  30.      terminating null character).  If the value returned is _n or more, the
  31.      contents of the array _s_1 are indeterminate.
  32.  
  33. EEEEXXXXAAAAMMMMPPPPLLLLEEEE
  34.      The value of the following expression is the size of the array needed to
  35.      hold the transformation of the string pointed to by _s.
  36.  
  37.           _1111 _++++ _ssss_tttt_rrrr_xxxx_ffff_rrrr_mmmm_((((_NNNN_UUUU_LLLL_LLLL_,,,, _ssss_,,,, _0000_))))_;;;;
  38.  
  39. FFFFIIIILLLLEEEESSSS
  40.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_llll_oooo_cccc_aaaa_llll_eeee_////_l_o_c_a_l_e_////_LLLL_CCCC______CCCC_OOOO_LLLL_LLLL_AAAA_TTTT_EEEE
  41.                               _LLLL_CCCC______CCCC_OOOO_LLLL_LLLL_AAAA_TTTT_EEEE database for _l_o_c_a_l_e.
  42.  
  43. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  44.      _cccc_oooo_llll_llll_tttt_bbbb_llll(1M), _ssss_eeee_tttt_llll_oooo_cccc_aaaa_llll_eeee(3C), _ssss_tttt_rrrr_cccc_oooo_llll_llll(3C), _ssss_tttt_rrrr_iiii_nnnn_gggg(3C), _eeee_nnnn_vvvv_iiii_rrrr_oooo_nnnn(5).
  45.  
  46. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  47.      On failure, _ssss_tttt_rrrr_xxxx_ffff_rrrr_mmmm returns _((((_ssss_iiii_zzzz_eeee______tttt_)))) _----_1111.
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.